.TH E1432_SET_RANGE_CHARGE 3 E1432
.SH NAME
.nf
e1432_set_range_charge \- Set charge-amp range of E1432
e1432_get_range_charge \- Get current charge-amp range of E1432
.fi
.IX e1432_set_range_charge(3) 3
.IX e1432_get_range_charge(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_range_charge(E1432ID hw, SHORTSIZ16 ID,
                                  FLOATSIZ32 range_charge)
SHORTSIZ16 e1432_get_range_charge(E1432ID hw, SHORTSIZ16 ID,
                                  FLOATSIZ32 *range_charge)
.cE
.SH DESCRIPTION
\fIe1432_set_range_charge\fR sets the charge-amp range, of a single
channel or group of channels \fIID\fR, to the value given in
\fIrange_charge\fR.

\fIe1432_get_range_charge\fR returns the current value of the
charge-amp range, of a single channel or group of channels \fIID\fR,
into a memory location pointed to by \fIrange_charge\fR.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fIrange_charge\fR is the full scale charge-amp range in picoCoulombs.
Signal inputs whose absolute value is larger than full scale will
generate an ADC overflow error.  (Actually, there is several dB of
overhead before the ADC will overflow, to avoid spurious overflow
indications.)

The actual charge-amp range that is set will be the nearest legal
range value that is greater than or equal to the value specified by
the \fIrange_charge\fR parameter.

The \fIrange_charge\fR parameter applies only to input channels, and
is used only when the input mode is \fBE1432_INPUT_MODE_CHARGE\fR (see
\fIe1432_set_input_mode\fR).  This is only possible when a Charge
Break-out Box is connected to the input.
.SH "RESET VALUE"
After a reset, the charge-amp range is set to 50000 pC.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_input_mode, e1432_set_range, e1432_get_range_charge_limits,
e1432_set_range_mike, e1432_bob
.ad
